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Başlarken 



Bu bölümde temel C++ ile Qt tarfmdan tedarik edilen fonksüyonları bir araya getirerek nasıl 
grafik kullanıcı arabirimi (GUI) yazılabileceğini bir kaç basit misal ile göstereceğiz. 
Bu bölümde yine Qt için çok önem arzeden ve iki temel taşı olan sinyaller ve dilimler ile 
dizim den bahsedilecektir. İkinci bölümde detaylara ineceğiz ve üçüncü bölümden itibaren 
artık gerçekçi programlar yazıyor olacağız. 



-1 



Merhaba Qt 



işte çok basit bir Qt programı: 

1 #include <qapplication.h> 

2 #include <qlabel.h> 

3 int main(int argc, char *argv[]) 

4 { 

5 QApplication app(argc, argv) ; 

6 QLabel *label = new QLabel ( "Merhaba Qt ! 

7 app. setMainWidget (label) ; 

8 label->show() ; 

9 return app.exec(); 
10 } 



0) ; 



Önce biz bu programı satır satır inceleyeceğiz ve daha sonrada nasıl derlenebileceğim 
göstereceğiz. 

Satır 1 ve 2 de QApplıcatıon ve QLabel sınıflarının tmmları programa dahil edilmektedir. 
Satır 5 de bir QApplicatıon nesnesi oluşturulmaktadır ki bu nesne programın temelini teşkil 
eder. QApplicatıon sınıfinm yapıcısı argc ve argv bağımsız değişkenlerini gerektiriyor, çünkü 
Qt nin kendine has birkaç komut satırı seçenekleri var. 



Satır 6 da bir QLabel ıvidget (vicıt diye telafîuz edilir) oluşturuyor ki o "Merhaba Qt" 
mesajını ekrana yansıtıyor. Qt ıstılahatmda, ıvidget kullanıcı arabiriminde grafiksel bir 
birimdir. Düğmeler, menüler, kaydrma çubuklar ve çerçeveler den her biri birer wdgetlardr. Bir 
wıdget bir başka wıdget ihtiva edebilir; mesela bir yazılım genellikle QMenuBar, QToolBar 
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ve QStatusBar ihtiva etmekle beraber daha başka wıdgetlarıda içerebihr. QLabel yapıcısının 
O bağımsız değişkeni bu widget m başka bir wıdget içerisinde yer almayıp başlı başına bir 
pencere teşkil ettiği anlamına gelir. 

Satır 7 label'ı bu programın ana widgetı yapar. Ne zamanki kullanıcı ana wıdgeti kapatırsa ( 
pencerenin başlığındaki X'e tıklamak suretiyle mesela) o zaman program sona erer. Ana 
wıdgeti olmayan bir program kullanıcı her ne kadar pencereyi kapatsada arka planda 
çalışmaya devam eder. 

Satır 8 label'in ekranda g.özükmesini sağlar. Widgetlar ilk yapıldıklarında ( satır 6) ekranda 
gözükmezler taki tüm değişiklikler arka planda yapılsın ve ekranda titremelere neden 
olmasın. 

Satır 9 programın kumandasını Qt'ye verir. Bu aşamada program artık hazır bekleme 
vaziyeti alır ve tuşa basılması veya fare tıklaması gibi komutları bekler. 

Kullanıcının eylemine olaylar (yada mesajlar) meydana getirir ve program bunlara bir veya 
daha fazla fonksiyonu koşturarak karşılık verir. Çalışmaları itibariyle GUI programları 
alışılmış toplu işlem programlarından farklıdırlar. Toplu işlem programları genelde girdiyi 
alır, sonucu üretir ve kullanıcı temasına gerek kalmadan sona erer. 




Şekil 1.1: Merhaba (Red Hat Linux) 

Şimdi artık programı sizin bigisayarımzda denemenin zamanı. Önce Ek A da açıklandığı gibi 
Qt 3.2 (yada daha yeni bir versiyonu) bilgisayarınıza kurmanız gerekli. Şu andan itibaren biz 
sizin bilgisayarınızda Qt 3.2 nin kurulmuş olduğunu ve bin dizininin PATH değişkeninde yer 
aldığını varsayacağız. (Widonwsda bu kurucu tarafından otomatik olarak yapıldığından sizin 
herhangi bir şey yapmanıza gerek yok.) 

Merhaba programının kaynak kodunu merhaba isminde bir dizinin içinde merhaba.cpp ismi 
ile kaydeiniz. Peoğramm kodunu bilgisayarda yazabileceğiniz gibi kitapla birlikte gelen CD 
den de kopyalayabilirsiniz {\misaller\bab01\merhaba\merhaba.cpp.) 

Her hangi bir komut isteminden merhaba isimli dizime geçiniz ve 

qmake -project 

yazınız ve böylece işletim sisteminden bağımsız proje dosyasını (merhaba.pro) oluiturmuş 
olacaksınız. Daha sonra 

qmake merhaba.pro 

yazmak suretiyle kullandığınız işletim sistemine has Makefile oluşturunuz. Eğer Makefîle 
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oluşturulurken bir hata zuhur etmediyse, make yazmak suretiyle programı derleyebilirsiniz. 
Yeni oluşturduğunuz bu program Windows altında merhaba ve unix altında ./merhaba 
yazılarak koşturulabilir. Şayet Microsoft Visual C++ kullanıyorsanız, make yerine nmake 
kullanmalısınız. Windows altında 

qmake - tp ve merhaba. pro 

yazmak suretiyle Visual Studio proje dosyası oluşturup derleme işlemini Visual Studio 
altmdada yapabilirsiniz. 



merhaba J H E H' 



Merhaba Qt! 



Şekil 1.2. Basit HTML formatı içeren bir label (etiket) 

Gelin biraz eğlenelim şimdi: Etiketi, basit bir takım HTML formatları kullanmak suretiyle, 
renklendireceğiz (Şekil 1.2). Bunu 

QLabel *label = new QLabel ( "Hello Qt ! " , 0); - ^,^ 

satırının yerine 

QLabel *label = new QLabel ( "<h2><i>Hello</i> " 

"<font color=red>Qt!</font></h2>", 0); 

satırını kullanmak suretiyle gerçekleştirebiliriz. 

Bağlantıların yapılışı 

Bu misal kullanıcı eylemlerine nasıl karşılık verilebileceğini göstermektedir. Bu örnek 
tıklandığında programı durduracak bir düğmeden ibarettir. Kaynak kodu Merhaba 
programına çok benzemekle birlikte tek fark QLabel yerme QPushButton ana wıdget olarak 
kullanılması ve bir kullanıcı eyleminin (düğmeye tıklama) bir parça koda bağlanmasıdır. 

Kaynak kodu CD de \misaller\bab01\cik\cik.cpp dosyasında bulabilirsiniz. 




Şekil 1.3. Çık programı 



1 #include <qapplication.h> 

2 #include <qpushbutton.h> 

3 int main(int argc, char *argv[]) 

4 { 
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7 

8 

9 
10 
11 
12 } 



QApplication app(argc, argv) ; 
QPushButton *button = new 

QpushButton(QObject: :trUtf8 ("Çık") , 0) ; 
QObject : ıconnect (button, SIGNAL (clickedO ) , 

&app, SLOT(quit 
app . setMainWidget (button) ; 
button - >show ( ) ; 
return app . exec ( ) ; 



Qt nin widgetları kullanıcı faliyetlerini ve durum değişikliklerini bildirmek maksadıyla 
sinyaller neşrederler. Mesela QPushButton düymeye basıldığında clıckedO diye bir sinyal 
yayar. Sinyal bir fonksiyona bağlanabilir. Bir sinyalin bağlanabildiği fonksiyona dilim adı 
verilir ve ne zamanki o sinyal neğredilirse bağlı bulunduğu dilim otomatik olarak icra edilir. 
Bizim misalimizde düğmenin cickedO sşnyalini Qapplicatioon nesnesinin quit() dilimine 
bağladık. . SIGNALO ve SLOT() makroları bağlantıların bölünmez bir parçasıdır ve bir 
sonraki bölümde detaylı olarak ele alınacaklardır. 

Şimdi programı derleyeceğiz. Biz sizin cik isminde bir dizi oluşturduğunuzu ve bı dizinin 
cik.cpp isminde programı içerdiğini varsayacağız. Önce qmake koşturarak proje dosyasını 
oluşturunuz, sonra yine qmake kuUnarak Makefile yapınız. Bütün bunları cik dizisinin 
içindeyken yapmalısınız: 

qmake -project 

qmake cik.pro 



Şimdi programı derle ve koştur. Eğer çık düğmesine tıklayacak yada ara tuşuna basacak 
olursanız programın sona erceğini göreceksiniz. 

Bir sonraki misal sinyal ve dilim mekanizmasını kullanarak nasıl iki wıdgetin birbiriyle 
beraber hareket etmelerinin sağlanabileceğini göstermektedir. Program kullanıcıya yaşını 
sormaktadır ve o da ya fırıldak kutusu yada kaydırıcı vasıtasıyla girebilir. 



Yaşınızı giriniz 



İ35 V L. 



* 



-J 



Şekil 1.4. Yaş programı 

Bu program bir QSpinBox, bir QHBox (yatay dizim kutusu) ve bir Qslider dan müteşekkildir. 
QHBox programın ana widgetıdır. QSpinBox ve QSlider QHBox m içerisinde 
görüntülenmektedirler bundan dolayı onlar QHBox m çocuklarıdırlar. 



Qt nin sinyalleri ile Unix sinyalleri arasında her hangi bir ilişki olmamakla beraber, biz 
bu kıtapda sadece Qt sinyalleri üzerinde duracağız. 
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Şekil 1.5. Yaş programının widgetleri 



1 #include <qapplication.h> 

2 #include <qhbox.h> 

3 #include <qslider.h> 

4 #include <qspinbox.h> 

5 int main(int argc, char *argv[]) 

6 { 

7 QApplication app(argc, argv) ; 

8 QHBox *hbox = new QHBox(0); 

9 hbox->setCaption (QObject : : trUtf 8 ("Yaşnızı giriniz") ) ; 

10 hbox->setMargin(6) ; 

11 hbox->setSpacing (6) ; 

12 QSpinBox *spinBox = new QSpinBox (hbox) ; 

13 QSlider *slider = new QSlider (Qt : ıHorizontal , hbox) ; 

14 spinBox->setRange (O, 130); 

15 slider->setRange(0, 130); 

16 QObj ect : : connect (spinBox, SIGNAL (valueChanged (int) ) , 

17 slider, SLOT (setValue (int) )) ; 

18 QObj ect :: connect (slider, SIGNAL (valueChanged (int) ) , 

19 spinBox, SLOT (setValue (int) )) ; 

20 spinBox->setValue (35) ; 

21 app. setMainWidget (hbox) ; 
2 2 hbox->show() ; 

2 3 return app.exec(); ' 

24 } 



QHBox, 8 ile 11 inci satırlar arasında oluşturulduktan sonra, setCaprionO fonksiyonunu 
kullanarak baslık çubuğunun metni değiştiriliyor. Daha sonra çocukların aralarında ve 
etraflarında 6 piksellik bir boşluk bırakıyoruz. 

Satır 12 ve 13 de bir QSpinBox ve birde QSlider oluşturulmaktadır ki her ikisininde ebeveyni 
QHBox dır. 

Her ne kadar biz her hangi bir widgetin yerini ve boyutlarını bizzat vermedıysekte, 
QSpinBox ve Qslider, QHBox m içinde gayet makul bir şekilde ve büyüklükte yerleştirilmiş 
olduklarını görüyoruz. Bunun sevebı QHBox m çocuklarının her biri için gerekli olan ebatı 
ve müsait makamı otomatğk olarak vermesidir. Qt, QHBox gibi daha bir çok sınıflar tedarik 
etmektedirkı buda programcıyı doğrudan wıdgetlerin ebat ve yerlerini belirleme yükünden 
kurtarır. 



Satır 14 ile 15 de geçerli fırıldak kutusu ve kaydırıcı limitleri verilmektedir. Onaltmcı ve 
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ondokuzuncu satırlardakı connectO fonksiyon çağrıları, fırıldak kutusu ve kaydırıcımn 
birbirleri ile irtibat halinde olmalarını sağlarlar ve birinin değeri değiştirildiğinde diğerinin 
değeride otomatik olarak değişir. Bir widgetin değeri depişdiğinde, o widget valueChanged 
(int) sinyalini yayınlar ve bu diğer widgetin setValue(int) diliminin çağrılmasına neden olur 
ki bu fonksiyon sözkonusu widgetin değerini güncelleştirir. t 

Satır 20 de fırıldak kutusunun değeri 35 yapılır. Dikkat edilirse biz kaydırıcımn değerini 
girmedik, bunun sebebi ise 20. satırda olup bitenler fırıldak kutusunun valueChanged(int) 
sinyalinin 35 değişkeniyle yayınlamasına sbep olacak ve buda QSlider widgetının setValue 
(int) dilimine değişken olarak gönderilecek neticede kaydırıcımn değeri 35 olarak ayarlanmış 
olacak. Kaydırıcımn değeri değişince oda valueChanged(int) sinyalini yayınlıyor buda 
fırıldak kutusunun setValue(int) diliminin çağrılmasına neden oluyor. Ancak fırıldak kutusu 
bu noktada 35 değerini tuttuğu için o artık değerinin değiştiğine dair herhangi bir yayın 
yapmaz. Böylece kısır döngü engellenmiş olur. Şekil 1.6 bu meseleyi özetlemektedir. 
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Şekil 1.6 Bir değeri değiştirmeye kalkınca her iki değer birden değişiyor 

Satır 22 QHBox ve iki çocuğunu görüntüler. Qt nin kullanıcı arabirimi oluşturulmasmdaki 
yaklaşımı kolay anlaşılabilir ve gayet esnektir. Qt programcıları genelde gerekli widgetları 
oluşturduktan sonra onların özelliliklerini istedikleri şekilde değiştirirler. The most common 
pattern that Qt programmers use is to instantiate the required widgetsand then set their 
propertiesas necessary. Programcılar widgetları dizimlerin içerisine yerleştirirler ve dizimler 
otomatik olarak widgetların ebat ve ekrandaki yerlerini ayarlarlar. Kullanıcı arabirimlerinin 
davranışları Qt nin sinyaller ve dilimler mekanizması sayesinde widgetlarin birbirlerine 
rapdtedilmeleri ile sağlanır. 

Referans dokümantasyonun kullanımı 

Qt nin referans dokümantasyonu*, bütün fonksiyon ve sıfları ihtiva etmesi sebebiyle, Qt 
programcıları için çok büyük bir önem arzeder. Qt 3.2, örneğin, 400 den faxla sınıf ve 6000 
den fazla fonksiyonu ihtiva eder. Bu kitaptaki misallerde çok sayıda Qt sınıf ve fonksiyonları 



Kanatimizce Qt referance dokümantasyonunun, malesef, sadece İngilizce versiyonu 
mevcuttur. Bu kitap bildiğimiz kadarıyla lisanımızla yayınlanan en kapsamlı Qt 
referansıdır bunun böyle ittihaz edilmesini temenni ederiz. 
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kullanılmaktadır ancak bunlardan bütün detayları ile bahsetmek yada bütün sınıfları ve 
fonksiyonları misallerle anlatmak malesef bu kitabın sahası dahilinde değildir. Bundan 
dolayı referans dokümantasyonunu behemehal kullanma durumunda olacaksınız. 

Qt nin dokümantasyonu doc\html dizini altında mevcut olup har hangi bir web gözatıcısı 
kullanılarak erişilebilir. Qt Assistant isminde Qt ile gelen yaedım gözatıcısı Qt nin yardım 
dosyalarını okumak için gayet elverişlidir. Windiws da Başla menusunun altında, Qt 
menüsünden Qt Assistant başlatılabilir. Unix altında ise komut isteminde assistant 
yazılarak yardım dosyalarına ulaşabilirsiniz, ve Mac OS X Bulucusu içinde assistant a iki 
defa tıklayınız. 

Ana sahifedeki API Reference başlığı altında mevcut olan bağlantılar bir çok bakımdan Qt 
sınıflarını incelemenize imkan sağlarlar. Ali Classes başlığı altında Qt de mevcut olan bütün 
smfları bulabilirsiniz. Main Classes sayfası sadece en öok kullanılan ana smflar hakkında 
bilgi içermektedir. Alıştırma olması bakımından şu ana kadar misallerde kullandığımıx 
sınıflar hakkında referans dokümantasyonunu kullanarak bilgi edinmeye çalış. Şuna dikkat 
edilmelidirki, kalıtsal (inherited) fonksiyonşar ana sınıf altında tasvir edilmektedirler; 
mesela, QPushButton sınıfının kendine has show() diye bir fonksüyonmu olmayıp aksine o 
ona QWideget sınıfından miras kalmıştır. Şekil 1.10 da şu ana kadar karşılaştığımız 
sınıfların birbirlerine nasıl mutaallik olduklarını müşahade edebilirsiniz. 

Qt nin hali hazırdaki versiyonu ve bir kısım eski versiyonlarının referans dokümantasyon- 
larına internet de httD://doc.trolltech.com/ adresinden ulaşabilirsiniz. Yine bu sayfada Qt 
tarafından her üç ayada bir çıkarılan Qt Quarterly ile Qt programmers neıvsletter adındaki 
cerideyi burada bulabilirsiniz. 
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Widget Tipleri 



Şu ana kadar gördüğümüz ekran resimleri Redhat Linux altında alınmıştır, ancak Qt 
programlarına desteklenen işletim sistemlerinden istediğiniz herhangi birisinin 
görüntüsünü verebilirsiniz. Qt nin bu olanağı sağlayabilmesindeki tılsım, onun her bir 
platformun kendine has araç kutularını kullanmak yerine (Windows XP ve Mac hariç ) 
onlari taklit etmesidir. 



Yaşınızı grrînrz ) H H D 



Yaşınızı grrînrz J H S Ö 



Fİ 



-j- 



[s~îir 



Windows 



Yaşınızı gfriniz } 






T 



Motif 



Yaşrnızı grnnrz ) H B H 



MotifPlus 




35 


îir 


1 








CDE 




m 


Yaşınızı grrînrz 




35 


'ar 






. m 


1 



Platinum SGI 

Şekil 1.7: Her işletim sisteminde kuUamlabşlecek tipler. 

Qt prğramlarımn görünümü -style komut satırı seçeneğini kullanmak suretiyle 
değiştirilebilir. Mesela, daha önce gördüğümüz yaş programına Unix işletim sistemi 
altında Platinum görünmü komut satırında aşağıdaki komutu kullanarak verilebilir. 



./yas - style=Platinum 
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Şekil 1.8: Sadece Windpws XP veya Mac sistemine mahsus tipler. 

Diğer işletim sistemlerinin zıddına, Windows XP ve Mac görünümü ancak kendi işletim 
sistemleri altında verilebilir çünkü Qt bu görünümleri verirken sistemin kendisine 
dayanmaktadır. 
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Qt Assrstant - OAppİrcatfon Class 



File Edit View Go Bookmarks Help 
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QArrav Class Reference (obsolete) 

QAsciiCache 

QAsciiCachelterator 

QAsciiDict 

OAsciiDictiterator 

OAssistantClient 

QAxAggregated 

QAxBase 

QAxBindable 



/usr/lib/qt-3.3/doc/html/classes.html 



QApplication . 
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QApplication Class Reference 

I The QApplication class manages the GUI application's control flow and main settings. 
More... 

I #includ.e < qapplicat.ion .h. > 

Inherits OObject . 

I List of ali member functions. 

Public Members 

• OApplicatlon ( int & argc, char ** argv ) 

• OApplicatlon ( int & argc, char ** argv, bool GUlenabled ) 

• enum Tvpe { Tty, GuiClient, GuiServer } 

• OApplication ( int & argc, char ** argv, Type type ) 

• OApplication ( Display " dpy, HANDLE visual = O, HAMDLE colormap = O ) 

• OApplication ( Display - dpy, int argc, char *- argv, HAMDLE visual = O, 
HANDLE colormap = O ) 

• Virtual -OApplication () 

• int argc () const 



Şekil 1.9: Qt assisstant 
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Şekil 1.9: Şu ana kadar karşılaştığımız Qt sınıflarının soy ağacı 



